[[b WikiWriter]] markup is intended to be quick to write, easy to read, and sensible to use. I put the whole syntax on this one page, in case you'd like to print it out for reference.
Topics: <a href="#PageLinks">Page Links</a> | <a href="#CreatePage">Create New Page</a> | <a href="#HereLinks">Here Links</a> | <a href="#ExternalLinks">External Links</a> | <a href="#Headings">Headings</a> | <a href="#Paragraphs">Paragraphs</a> | <a href="#Bullets">Bulleted Lists</a> | <a href="#Numbers">Numbered Lists</a> | <a href="#Mixed">Mixed Lists</a> | <a href="#Spans">Spans</a> | <a href="#Divs">Divs</a> | <a href="#Images">Images</a> | <a href="#Tables">Tables</a> | <a href="#Macros">Macros</a> such as Included Files, Index Entries, HeadInfo, Title Commands
=== HTML is Okay
If you are comfortable writing HTML markup, go right ahead and use it. HTML works just fine in [[b WikiWriter]]. But it's easier and faster to use [[b WikiWriter's]] simplified markup with features like automatic page creation and linking and quick layout with DIV blocks.
=== WikiWriter Markup
[[b WikiWriter]] has special markup for links (double-parentheses), inline formatting (double-brackets), and structure commands (token [[i followed by a space]] at the beginning of a line). Explanations and examples follow, below.
<a name="PageLinks"></a>
=== Page Links
To create a link to an [[b WikiWriter]] page, put the page name in double parentheses:
<pre>
((Getting Started))
</pre>
will produce the link ((Getting Started))
<a name="CreatePage"></a>
Create a new page by writing a link for the page. When you [[b Save]] your text, then click on the new link in the displayed page, [[b WikiWriter]] will create the page. Select [[b Edit page]], and go to work on it.
<a name="HereLinks"></a>
=== "You are here" Links
Links to the current page have the "here" style applied to them:
<pre>
((Markup Syntax))
</pre>
will look like ((Markup Syntax)). This is a feature for building navigation lists, like the box in the upper right corner of this page. Build a list of page links in a separate file, include that file on each page, and [[b WikiWriter]] will highlight the current page in the list to give the viewer a sense of location. You can disable this effect by deleting or commenting-out the "here" style in the CSS file.
<a name="ExternalLinks"></a>
=== Web Links
External links, to Web sites in the Outside World, will work (of course!) only while you are connected to the Internet. Since the external site will not know about your [[b WikiWriter]] project, there will be no way to get back when you follow an external link. Therefore, [[b WikiWriter]] will create a link that uses [[b target="_blank"]] in the link reference so the link will open a new browser window. Then users can close the external link window when they're done, to return to [[b WikiWriter]].
External links use the full URL, in single brackets
which will produce the link [http://hytext.com/]. Notice the brackets are still in place, as a sign to the user that the link is external.
You can use a link description by following the URL with a space. Anything after the space, still inside the brackets, will be the link description. So:
<pre>
[http://hytext.com/ HyText Wiki Works]
</pre>
will produce a link that looks like [http://hytext.com/ HyText Wiki Works] without the inelegant URL stuff.
<a name="Headings"></a>
=== Headings
Use leading equal signs to designate a line for a heading. Heading levels 1-6 are supported by [[b WikiWriter]]:
<pre>
= Heading One
== Heading Two
=== Heading Three
==== Heading Four
===== Heading Five
====== Heading Six
</pre>
produces:
= Heading One
== Heading Two
=== Heading Three
==== Heading Four
===== Heading Five
====== Heading Six
[[b Note that you must have a space between the equal sign(s) and the text.]]
<a name="Paragraphs"></a>
=== Paragraphs
Create paragraph endings by pressing [[b Enter]]. You may use one or more blank lines, if you wish. In the HTML display, only one blank line will appear between paragraphs, no matter how many blank lines you have in the source text. Paragraph spacing is controlled by the CSS file.
<a name="Bullets"></a>
=== Bulleted (Unordered) Lists
Indicate a list item with a leading star (asterisk (*)) with a space separating it from the text. Use two, or three, stars to produce second or third level sublist (list item indentation). A slash-star(/*) marks the end of a list or sublist. You need a slash-star for each level you want to end:
<pre>
* List item one
* List item two
* List item three
** Second level item
** Another second level item
*** Third level item
/*
/*
* Back at level one
/* End of list
</pre>
produces:
* List item one
* List item two
* List item three
** Second level item
** Another second level item
*** Third level item
/*
/*
* Back at level one
/* End of list
<a name="Numbers"></a>
=== Numbered (Ordered) Lists
Use hash marks (#) for numbered lists, with a slash-hash (/#) to end a list or sublist:
<pre>
# List item one
# List item two
# List item three
## Second level item
## Another second level item
### Third level item
/#
/#
# Back at level one
/# End of list
</pre>
produces:
# List item one
# List item two
# List item three
## Second level item
## Another second level item
### Third level item
/#
/#
# Back at level one
/# End of list
<a name="Mixed"></a>
=== Mixed Lists
You can mix bullets and numbers:
<pre>
# List item one
# List item two
# List item three
** Second level bullet
** Another second level bullet
*** Third level bullet
/*
/*
# Back at level one
/# End of list
</pre>
# List item one
# List item two
# List item three
* Second level bullet
* Another second level bullet
** Third level bullet
/*
/*
# Back at level one
/# End of list
<a name="Spans"></a>
=== Spans
Mark text with double brackets for applying a SPAN style for inline text formatting. The first word in the brackets is the style name listed in the CSS file. For instance, "b" for bold, "i" for italics, and "rev" for reverse are in the default CSS file.
<pre>
For instance, [[b "b" for bold]], [[i "i" for italics]],
and [[rev "rev" for reverse]] are in the default CSS file.
</pre>
For instance, [[b "b" for bold]], [[i "i" for italics]], and [[rev "rev" for reverse]] are in the default CSS file.
You can nest spans if the nesting is logical, but you have to keep track of the brackets:
<pre>
This would be [[b [[i [[rev bold italic reversed]]]]]].
</pre>
This would be [[b [[i [[rev bold italic reversed]]]]]].
Available SPAN styles are in the SPANS sections of the [[b iwiki.css]] CSS file, as shown in the SPAN Styles dropdown list in the [[b WikiWriter]] menu bar.
<a name="Divs"></a>
=== Divs
For blocks of text (and/or graphics, lists, other blocks, etc.) use DIV elements named in the CSS file. Open the DIV with a dot and the class name (followed by a space if you have additional text on the same line), and close it with a dot and "end" where you want to terminate the effect of hte DIV.
<pre>
.result This is a "result" DIV.
.end
</pre>
.result This is a result DIV.
.end
The appearance and behavior of DIVs is specified in the CSS file. If you nest DIVs, you have to close with a dot-end for each DIV in the set:
<pre>
.plan This is a "plan" DIV...
.result ... holding a "result" DIV.
.end
.end
</pre>
.plan This is a "plan" DIV...
.result ... holding a "result" DIV.
.end
.end
Available DIV styles are in the DIVs sections of the [[b iwiki.css]] CSS file, as shown in the DIV Styles dropdown list in the [[b WikiWriter]] menu bar.
<a name="Pre"></a>
=== Preformatted Text
The HTML "PRE" tag serves to block [[b WikiWriter]] display formatting and show the raw text. To disable HTML tags in a PRE block, you must replace any left-angle brackets (the opening mark for an HTML tag) with ampersand-lt-semicolon (<).You can see how to use the PRE tag by selecting [[b Edit page]] and looking at the source for this page. Use [[b Cancel Editing]] to get back to the display view of the page.
<a name="Images"></a>
=== Images
Use typical HTML to call in an image:
<pre> <img src="frog.gif">
</pre>
gives you <img src="frog.gif">
<a name="Tables"></a>
=== Tables
You have to use HTML markup to create tables. There's the PRE tag version:
[[b Include]] — To include one [[b WikiWriter]] page in another, use the token "@@inc" at the beginning of a line, followed by a space and the page name:
<pre>
@@inc HelpTOC
</pre>
inserts the navigation menu at the top of this page, for instance. The menu itself is at ((HelpTOC)). Notice that the menu simply lists the links for the Help project. The "here" link processing identifies the link for the current page, and gives it special display treatment according to the "here" style in the CSS file.<a href name="Index"></a>
[[b Index]] — To add an item for indexing, put the item on a separate line, marked with @@index. Use commas to separate multiple items in a single index entry line:
<pre>
@@index Indexing
@@index navigation, edit box, syntax
</pre>
To build an index for a project, select the menu item [[b Tools > Build Index]]. The system will scan all the pages in the project and build an index file [[b index.db]] list index entries with their pages.
<a href name="HeadInfo"></a>
[[b Headinfo]] — To insert information to be included in an HTML page's HEAD element, put the item on separate lines starting at the very top of the file, each line marked with @@headinfo:
To provide an alternative to the default page title (derived from the page filename), use @@title:
<pre>
@@title Markup Syntax
</pre>
The filename for this page is [[b markup.db]], and the default title is therefore [[b markup]]. The above macro entry gives this page the title [[b Markup Syntax]] when the page is converted to HTML, making the page more presentable (since the title is displayed in the window title bar) and more accessible to search engines (which use the title to display search results)when uploaded to a web site.
[[b SuperComment]] — You can already put non-displaying comments into your pages with the HTML <!-- and --> tags. To create non-compiling SuperComments, readable in WikiWriter source .DB files but not compiled out to HTML or MHT pages, bracket the comment block with !! and /! starting in the first column of a line:
<pre>
!! SuperComment block starts here -- this line does not compile.
Any lines in this block do not compile.
/! SuperComment ends here -- this line does not compile, but any lines after it do compile.
